DICE API Documentation/com.embabel.dice.web.rest

Package-level declarations

Types

data class ChunkSummary(val chunkId: String, val propositionCount: Int, val preview: String)

Summary of a processed chunk.

data class CreatePropositionRequest(val text: String, val mentions: List<MentionDto> = emptyList(), val confidence: Double = 0.9, val decay: Double = 0.0, val reasoning: String? = null)

Request to create a proposition directly.

DeleteResponse

data class DeleteResponse(val id: String, val status: PropositionStatus, val previousStatus: PropositionStatus?)

Response for delete operation.

DiceRestConfiguration

class DiceRestConfiguration

Opt-in Spring configuration that activates all DICE REST controllers.

DiscoveryController

class DiscoveryController(store: PropositionStore, projectionRecordStore: ProjectionRecordStore, collectorRunner: CollectorRunner)

Opt-in REST surface exposing the discovery operations over OpenAPI-discoverable endpoints, all returning only the leak-free discovery DTOs.

EntityMemoryResponse

data class EntityMemoryResponse(val entity: EntityReference, val propositions: List<PropositionDto>)

Response for memory by entity.

EntityMentionDto

data class EntityMentionDto(val name: String, val type: String, val resolvedId: String?, val role: String)

EntityReference

data class EntityReference(val id: String, val type: String, val name: String?)

EntitySummary

data class EntitySummary(val created: List<String>, val resolved: List<String>, val failed: List<String>)

ExtractErrorResponse

data class ExtractErrorResponse(val error: String)

Body of a 400 from the extraction endpoints.

ExtractOptions

data class ExtractOptions(val schemaAdherence: SchemaAdherenceDto = SchemaAdherenceDto.DEFAULT)

ExtractRequest

data class ExtractRequest constructor(val text: String, val sourceId: String? = null, val knownEntities: List<KnownEntityDto> = emptyList(), val schemaName: String? = null, val options: ExtractOptions = ExtractOptions(), val sourceLocator: SourceLocatorInputDto? = null, val sourceRevision: String? = null)

Request to extract propositions from text.

ExtractResponse

data class ExtractResponse(val chunkId: String, val contextId: String, val propositions: List<PropositionDto>, val entities: EntitySummary, val revision: RevisionSummary?)

Response from extraction endpoint.

FileExtractResponse

data class FileExtractResponse(val sourceId: String, val contextId: String, val filename: String, val chunksProcessed: Int, val totalPropositions: Int, val chunks: List<ChunkSummary>, val entities: EntitySummary, val revision: RevisionSummary?)

Response from file extraction endpoint.

GovernanceController

class GovernanceController(operations: GovernanceOperationsService)

The HTTP half of the schema governance operator surface: read the drift log and the current declaration, run a check, release a quarantined proposition.

InvalidSourceProvenanceException

class InvalidSourceProvenanceException(message: String) : RuntimeException

A request whose source locator or revision the extraction endpoints refuse.

KnownEntityDto

data class KnownEntityDto(val id: String, val name: String, val type: String, val description: String? = null, val role: String = "A referenced entity")

MemoryController

class MemoryController(propositionRepository: PropositionRepository)

REST controller for DICE memory operations. Provides endpoints for managing stored propositions (CRUD, search, retrieval).

MemoryResponse

data class MemoryResponse(val contextId: String, val count: Int, val propositions: List<PropositionDto>)

Response for memory retrieval.

MemorySearchFilters

data class MemorySearchFilters(val status: List<PropositionStatus>? = null, val mentionTypes: List<String>? = null, val minConfidence: Double? = null)

MemorySearchRequest

data class MemorySearchRequest(val query: String, val topK: Int = 10, val similarityThreshold: Double = 0.7, val filters: MemorySearchFilters = MemorySearchFilters())

Request to search memory by similarity.

MemorySearchResponse

data class MemorySearchResponse(val contextId: String, val query: String, val results: List<SimilarityResultDto>)

Response for memory search.

MentionDto

data class MentionDto(val name: String, val type: String, val suggestedId: String? = null, val role: String = "OTHER")

PropositionDto

data class PropositionDto(val id: String, val contextId: String, val text: String, val mentions: List<EntityMentionDto>, val confidence: Double, val decay: Double, val reasoning: String?, val grounding: List<String>, val provenance: List<ProvenanceEntryDto>, val created: Instant, val revised: Instant, val lastAccessed: Instant, val status: PropositionStatus, val action: String? = null)

Proposition DTO for API responses.

PropositionPipelineController

class PropositionPipelineController(propositionPipeline: PropositionPipeline, propositionRepository: PropositionRepository, entityResolver: EntityResolver, schemaRegistry: SchemaRegistry, contentReader: <Error class: unknown class> = TikaHierarchicalContentReader(), contentChunker: <Error class: unknown class> = InMemoryContentChunker( config = ContentChunker.Config(), chunkTransformer = ChunkTransformer.NO_OP, ), objectMapper: <Error class: unknown class> = jacksonObjectMapper())

REST controller that runs the proposition extraction pipeline over text or uploaded files.

ProvenanceEntryDto

data class ProvenanceEntryDto constructor(val locator: String, val display: String?, val chunkId: String?, val startOffset: Int?, val endOffset: Int?, val contentHash: String?, val sourceRevision: String? = null)

Slim view of where a proposition came from — one source reference per entry.

RevisionSummary

data class RevisionSummary(val created: Int, val merged: Int, val reinforced: Int, val contradicted: Int, val generalized: Int)

SchemaAdherenceDto

enum SchemaAdherenceDto : Enum<SchemaAdherenceDto>

SimilarityResultDto

data class SimilarityResultDto(val proposition: PropositionDto, val score: Double)

SourceLocatorInputDto

data class SourceLocatorInputDto(val kind: String, val value: String, val connectorId: String? = null, val display: String? = null)

A source locator on the wire. kind picks which of the four locator types to build and decides what the other fields mean: connector is the only kind that takes a connectorId, and the other three reject it rather than ignore it.